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NOTE: >todific3tion on Micropolis Interface Bosrd 



for running MZOS 



Jumpers in address area should bo changed from F4 to D8. (Remove jumper on iV3, 
add jumpers to Wl and W4) . The attached diagram shows where junpers should be 
added. 




Address Jumpers 
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INTfOXJCTION 

The Vector MZ operating system, MZOS, was designed specifically for the MZ 
system. It is a file-oriented disk operating system, allowing you to maintain 
and use files on the disk. Also provided are subroutines whidi may be used by 
the assembly language programmer to interface other software to the disk system, 
or for programs like BASIC to load and save files on the disk. 

MZOS is a copyrighted software product of Vector Gr^ic Inc. and is meant only 

for us^ on an MZ or similar system from Vector Graphic. We assume no 
responsibility for unauthorized use. 

^ 

This manual reflects version 1.4 of MZOS. 
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FIIB STRUCTURE 



First, it is necessary to understand the layout of the disk and the files on it. 

Thorough understanding of this section will greatly aihance ease of operation of 
this system. 

The disk contains 77 concentric tracks, similar to the grooves in a record. 
Each track is divided into 16 sectors, and each sector contains one page (256 

bytes) of data. Thus the capacity of the ait ire disk is around 315K bytes. The 
tracks are numbered 0-76, and the sectors 0-15. For our purposes, however, the 
disk should be thought of as 1232 sectors, numbered 0-1231, forgetting about 
tracks altogether. 

The first four sectors on the disk are reserved for the directory. The purpose 
of the directory is to keep track of the files on the disk. There are 64 
entries allowed, therefore you may have as many as 64 files on the disk. Each 
entry in the directory uses 16 bytes. The format of eadi entry is as follows: 

FILENAME ADDRESS IfNGTH T^E ^TART SPECIAL 



10-7 18-9 I 10-11 I 12 I 13-14 I 15 I 
The meanings of each field are as follows: 

FILENAME 

An eight-byte field, this contains the name of the file. It maY contain any 
printing ascii character, ex|tept spaces, ccmnas, or lower-case letters. 

ADDRESS 

This two-byte field contains the address on the disk where the file begins. 
This address is actually just the sector number of that particular sector. 
Sector 278 would have a disk address, then, of 278. 

LEN3TH 

^e length of the file is the number of sectors it occupies. 

TYPE 

The type of a file is a ^)ecial reference to what the file might be used for. A 
file may be of type 0 through 99. Certain file types have already been defined. 
Ttiey are: 



0 Default type unless changed. 

1 Executable machine language program. 

2 BASIC program. 

3 BASIC data file. 

4 Ascii text file. 

5-7 Reserved . 

8 DEX Assembler source file 

9 Reserved. 



File types 10-99 are not currently used or reserved, so they can be used for 
special purposes. 
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START 

The start bytes are used to define the loading/starting address for type 1 
(machine language) files. In the case of BASIC files, they're used to define 
the amount of valid data within the file. 

SPECIAL 

This byte is not used, but is reserved for any i^yecial need we might dream up at 
some future tisne. 



The remaining 1228 sectors on the disk are available for files. There is a 

restriction that a file may only be 256 sectors long. Ttiis is not unreason^le, 
since it would be rather difficult to load a file longer that 64K into memory 
anyway. Actually, you may have a file longer then 256 sectors, but you will not 

be able to load, save, or verify it with MZOS. 

A fact to remember is that MZOS does not necessarily access a file vrfien it 

accesses the directory. Create, delete, and similar operations only modify the 
directory, not the actual file. Thus if you accidentally delete a file, you can 
recover it just creating it with the same addresses as it had before. If you 
need to create a bigger file, you can just delete the old one and then recreate 
it with a greater length and the same starting address. 

Another thing to remember is that MZOS maintains no copies of the directory in 
memory, so you m^ exchange disks at will. (This is as opposed to, say, CPU.) 
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MZ06 MEMORY lATOUT 



It is important to know the places in monory used by MZOS. There are actually 
three separate areas to know about. The first, symbolically called MZOS, is the 
actual operating system and buffer areas. Ihis resides in RAM from 2000-29FF. 
The top of this area is used for system i/o and is explained later. The second 
area is called MZIO and is a IK prom at address C400-C7FF. This is the second 
2708 on the prom/ram board. It contains all of the disk i/o routines. The 
third area/ MZTMP, is an approximately 32-byte block starting at DF40, in the 
ram area of the proin/ram board. Biis is used for the track table and similar 
important information. 

In addition to the regular area, a 2K area Immediately following MZ06 (actually 
2A00-31FF) is used for some mass transfer commands to achieve a higher speed. 

Execution of the IN, DT, CF, CD, or OQ commands will utilize this area, thus 
overwriting vrtiatever is there. 

Last but not least, there are several entry points to the system which you 
should know about. These, as well as the disk subroutines, are covered in 
^pendix A. 
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MZOS CONSOLE COMMANDS 



Following is an explanation of MZOS coiranands and their usage. The following 
conventions are used in this explanation: When something is enclosed in 
parentheses, e.g. (address), that argument is optional. Something in 
angle-brackets, e.g. <address>, means that you should substitute a valid 
argument; in this exanple, you should type an address. Also, all arguments are 
in decimal, with the exception of memory addresses, which are in hex. 

LI (<unit» 

This will list the directory on the specified unit, with the current disk as the 

default. Each file will be listed, followed by the address, length, protect 

status, type, and start address if the file is type 1. A sample listing is 
shown in appendix C. 

FL «unit>) 

This is similar to the LI command, only the directory is listed in a 'fast' 

format. Only the file is listed, six-wide across the page. Ihis is useful for 
seeing just if you have a particular file. 

CR <file> <length> (<address» 

The create comnnand allows you to create a file entry in the directory. The file 

will be created with the specified length. If an address is specified, it will 
be used/ otherwise the first free disk address will be defaulted to. 

DE <file> 

This will delete a file entry. Remember, the file itself will not be harmed, 
just the entry in the directory. A protected file cannot be deleted. 

EN <old-file> <new-file> 

This allows you to change the name of (rename) a file. All the other 
information (type etc.) will remain the same. Do not rename a file to a name 

that already exists! 

Ty <file> <type> «start addr» 

This sets the type of a file. If type 1 is ^)ecified, the start address MUST be 
specified. No accessing of the file is actually done, just the directory 
entry. 

PR <file> 

This protects the file specified. When a file is protected, it cannot be 
deleted. The file may still be written into, however 1 This is not a perfect 

protection, but it does keep you from deleting an iirportant file in a moment of 
frustration. IMPORTANT NOTE! Assembler source (type 8) and BASIC (types 2 and 
3) files MAY UJI be protected. If you do, any attempt by DEX or BASIC to look 

th^ up will fail. 
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UP <f ile> 

This will just unprotect a file. No error is caused by unprotecting a file that 
wasn't protected anyway* 

LF <f ile> <inem addr> 
SF <file> <mem addr> 
VF <file> <inem addr> 

These conunands load, save, or verify a file. The load and save cOTinands do so 
with respect to the monory address specified. Thus 'SF TEST 3000' would save 
memory into a file called TEST, starting at memory address 3000. Data will be 
written into the file sequentially until it is full. Hie LF command works in a 
similar manner, only data is read from the disk into memory. Hie VF command 
does no ram access; it verifies the file by doing an internal check on it. The 
memory address is necessary, though, so just use 0 as a dummy address, 

r 

CF <old-file> <new-file> 

This will copy the data from one file to another. In addition, the type and 
protect information will be copied too. Make sure that the destination file is 
at least as large as the source file, or you will receive an error. 

00 <file> 

This will load a type 1 file into memory at its start address and junp to it. 

Note that this is equivalent to using the LF command followed by a JP command to 
the start address of the file. Obviously, this only is for type 1 files. 

RD <addr> <mem addr> <sectors> 

WR <addr> <mem addr> <sectors> 
VR <addr> <mem addr> <sectors> 

These commands will read, write, or verify data directly oi the disk, with no 

regard for files. These commands are used infrequently, as normally all work is 

done with files. Using the RD caimand as an example, take the command RD 4 3000 

10. This will read 10 sectors, starting with address 4, and load them into 
memory beginning at address 3000 (hex). The WR and VR commands work similarly. 

The VR coinnand, like the VF command, does internal checking only. You may use 0 
as a dunnty ram address for this conmand. 

IN «unit» 

This will initialize a fresh diskette. It completely fills the diskette with 
spaces (ascii 20 hex). Ihis MUST be done to ALL diskettes before use, as they 
contain garbage before initialization. This ccximand also writes the sector id's 
on each of the sectors (These id's are used for error checking) . You shouldn't 
initialize a diskette that contains valid data, of course. 

nr «unit>) 

This will test a diskette by writing and then verifying a constantly changing 
pattern over the aitirety of the diskette. This destroys any data that was on 
the diskette, so use with caution, and NEVER on a diskette after it has valid 

data written on it. 
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CD <source> <dest> 

This will copy the entirety of the source diskette onto the destination 

diskette. No file-oriented access is used, just direct read and write. Hie 
resulting diskette is an exact duplicate of the source diskette. 

CO (<unit>) 

This compacts the data on the disk by moving all files toward the beginning of 
the disk. This can become necessary when you have several files, and you delete 
one or more out of the middle. See also a note in the usage section of this 

manual referring to this coirmand. 

JP <mem adr> 

This just transfers control to the specified address in memory. It is used, for 
exanple, to start a program that is already in memory. 

DD (<unit>) 

Ihis sets the default unit to the one specified. If no unit is specified, then 

unit 1 is used. All disk accesses, vdien no unit is specified, use the default 
unit. 

; <text> 

Typing a semicolon (;) as the first character of a line will cause the line to 

be ignored. Only thirty characters m^ be typed, though, or you will receive an 
error. 

<file> 

Typing a file name alone is exactly like typing GO followed by the file name. 
Thus BASIC and GO BASIC are identical ccmnands. 
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USAGE NOTES GN MZOS 

The following is a collection of things to know while using MZOS. 

r 

When typing a cotiinand^ it may be aborted at any time by typing control-C. To 

erase the last character typed, hit Backspace (if this doesn't suit you, see 
appendix A) . 

During execution of a coninand like DT or IN, you may abort execution by typing 
control-C . 

Typing control-X at ANY time ir?>ut is expected (as a COTmand, during a DT or IN, 
etc.) will return you to the prcxn monitor* 

The DT command will run until it finds an error or you stop it. 
The IN ccxnmand takes around a minute and a half. 

NEVER NEVER NEVER NEVER interrupt the execution of the CO command, unless you 

don't mind your diskette being totally destroyed. Compaction normally takes 

well under five minutes, but depending on the degree of disaster your diskette 
is in, it could take ten or twenty minutes to compact it. DON'T PANIC! A 
relatively messy disk could require over a million read/writes, and interrupting 

it in midstream is guaranteed to leave the disk in a totally unknown state. So 
unless the disk starts smoking or making really terrible sounds, just leave it 
alone . 

In a multiple-unit system, the particular drive which you wish to reference is 
indicated by adding a ,1 ,2 ,3 or ,4 to either a filename or disk address. Thus 
referencing the file TEST on unit 2 would look like TEST, 2; a reference to 
sector 24 on unit 3 would be 24,3. Ihis is true of ANY file reference, in any 
conmand; or of the disk address in the RD, WR and VR conmands. 

MZOS will digest lower case letters as well as upper case, since it just 
translates everything to upper case anyway. 

To repeat something said elsewhere, all disk accesses, where an explicit unit 
isn't specified, reference the disk specified in the last DO command. If no 
such axnmand has been issued, then unit 1 is used. 

If you have a printer interfaced with your system, you should know that error 
messages will oily print on the console, not the printer, even if the printer is 
enabled. This prevents getting error messages in the middle of a good 
printout. 

Needless to say, this operating system is conpletely compatable with the North 
Star DOS. It is specifically designed so that any software that runs on the 
North Star system will run on MZOS. 
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A reasonably comprehensive set of error messages are provided with MZOS, 
Following is a list of these errors and you might get them. 



Huh? 

This means that you typed something that MZOS can't possibly understand. 
Usually this is fron misspelling a connand. 

% Syntax error 

This indicates that you typed a valid command, but invalid arguments. Examples: 

TJf FILE 1 without a start address, or LF FILE QWERT where QWERT is obviously not 
a hex address. 



% File error 

This is caused by an invalid file reference. It can be caused by creating a 

file that already exists, referencing one that doesn't, trying to GO a 
non-type-1 file, and so forth. 

% Disk overflow 

You tried to create a file that would extend beyond the boundries of the disk 
(that is, past sector 1231). 

% Write protected 

You either tried to write on a protected disk, or tried to delete a file that is 
protected . 

m 

% Disk offline 

This can be caused by trying to access the disk \Aien. either there is no diskette 

in the drive, the drive is not up to speed, or the controller just isn't 
installed in the canExater. 

% Illegal argument 

An attempt was made to read, write, or verify beyond the boundries of the disk. 
Ihis is similar to the overflow error, only this refers to access attempts, 
rather that file creation. 



MZOS User's Manual 



Page 10 



% CRC error at sector xxxx,n 

Bad data was encountered on the disk in unit n^ at sector xxxx. ihis is usually 
caused by a faulty diskette, or access to an uninitialized diskette. 

% Sector id error at sector xxxxrn 

This means that the sector read was not the one wanted. The most connKXi cause 
of this is a glitch in the stqa?er motor , or possibly a bad diskette. 



Some software that does disk access may want to have control returned to it 

after an error occurs. Such software should put the address they want control 
sent to (on an error) into moiiory at address DF5C. Ihat address is the last two 
bytes of a jump instruction, which is used after any error. When it is 
finished, though, it should replace 2028 in that location. 
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FAMOUS LAST WORDS 



MZOS has been thoroughly tested, and should hopefully serve you well on your 

system. In the event you have any trouble, though, or need help in figuring out 
how it works, feel free to contact us for assistance. Vte would also appreciate 

any comments, suggestions, or improvements to this manual, or additions to or 

ideas for MZOS, that you might think up. 
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APPENDIX A: MZ06 ENTR^ POINTS 



Assuming you have sOTie familiarity with assembly language^ this should help you 
understand interfacing to MZOS. Although MZOS is actually a Z-80 program, these 
explanations will use 8080 code whenever possible as it seems to be more 
popular. 



MZOS 2028 

Hie MZOS entry point is where you jurtp to start MZOS. The monitor 'J' command 

will jump here very nicely. At the end of some other program, putting a JMP 
2028H will return oontrol to MZOS. 



MBoar C400 

This is where to jump to in order to boot \jg MZOS. Ttie monitor 'E' command can 
be used to initially do so. 



DOOM C402 or 2022 



This is the nitty-gritty disk i/o routine. All disk access can be done here. 
Basically, vAiat you do is set \jp the registers for what you want to do, then 
call here (either address will do, since 2022 is just a JMP 0C402H) . Ttie 
registers should be set up as follows: 

A number of sectors to access 

B command - see below 

C unit - 1, 2, 3, or 4 

DE ram address to read into or write from 

HL disk address (sector) to begin access at 



Commands are: 0 write from manory to disk 

1 read from disk to memory 

2 verify CRC internally (Xi disk 

3 seek (go to) sector specified only 

4 recalibrate drive (go to sector 0) 

The last two, seek and recalibrate, are mainly for test purposes. The 

recalibrate is used to insure proper positioning of the head, in case (for 
example) the track table is accidentally destroyed, or the stepper motor 

doesn't. 



DLOOK 201C 



Ohis is used to lookup a file in the directory. Looking ip a blank entry will 

locate a free space, for creating a new file. When this is called, A should 
contain the unit number, and HL should point to (contain the address of) a 
string of characters representing the file name, followed by either a return (OD 

hex) or a blank (20 hex) . 
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When this routine returns^ if the CY flag is set, then the file you looked up 
does not exist. In this case, HL contains the first free address on the disk. 
If CY isn't set, then the file was successfully found. In this case, HL points 
to the eighth byte of a copy of the entry. This copy is actually within the 
directory buffer of MZOS. See the file structure section of this manual for the 
structure of the entry. 



DWRIT 201F 

This will write a directory entry back to the disk. It is important that NO 

DISK ACCESS OCCUR between DLOOK and EWRIT. NOW, the procedure for reading a file 

would be to use DLOOK to lookup the file; assuming it is really there, 
incrementing HL will make it point to the starting disk address of the file; 
then use DCOM to actually read the file. To write a new file to disk, you would 

first lookup the file, to make sure that it doesn't already exist. This will 
fail, assuning the name isn't there yet. Next, lookup a blank name. In the 
event this fails (it shouldn't), the disk you're using doesn't have a directory 
on it, or is full. Anyway, now HL points to the eighth byte of a blank entry. 
Now you should copy in the file name, disk address (from your first lookup), 
length, type, and start address (if needed). This done, call DWRIT to update 
the directory. 



DLIST 2025 

This will print the directory of the unit specified in A. The list is exactly 
the same as the LI command. 



RHCHK 20 2B 

This is not an entry point, but rather a flag. If this byte is 1, then a verify 
will be done after a write. This will slow down write operations considerably, 
but may be desired if you don't trust your diskette. 



BSCHR 25F4 

This location contains the character that will be used for a backspace. 
Normally, this is an 08 (ascii backspace), but you may wish to change it. Ihe 
most common other characters used are underline (5F) or DEL (7F) . 



PRMPT 2071 

This location contains the character used as a praipt. Currently it is set to a 
nunber sign (#,23 hex) , but you may change it if you like. 
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APPENDIX B: OONSOIE I/O 



Here we will discuss the console i/o provided with your system, and how you may 
change it if necessary. 

First, there are four entry points in MZOS which reference console i/o. They 
are as follows. 



INCH 2010 

This will input a single character fron the console. 



OUTCH 200D 

This will output a single character. 



OUTPR 200A 

This will output a character to the printer. 



CHKCH 2016 

Ihis does two things. First, it checks vhether a character has been typed. If 

not, it returns immediately with the Z flag cleared. If a character has been 
typed, it sees if it was a control-C. If this is the case, then it returns, 

with Z set. Finally, if a character was typed, and it was a space, then another 

character is waited for. This allows you to momentarily suspend output by 

hitting the space bar. After another character is typed, this routine returns, 

with the Z flag set if that character was a control-C. 



TINIT 2013 

This is used to initialize the i/o system, if needed. It is currently set up to 

initialize the Bitstreamer board, but may be able to be replaced with RET 
instruction. 



So. Those are the entry points. The actual routines, though, are located in a 
64-byte block from 2900-29FF. A listing is provided of the routines as 
provided, in case your system is different. 

Checking with the listing, notice that there are addresses assigned to each 

routine. They are spaced far enough apart that you should be able to fit in any 
of your own routines without moving any other routine. This means that you 
shouldn't have to patch the junp table (entry points) at all. 



2900 








M 

0001 


* MZOS 


STANDARD l/O SYSTEM 


2900 








0002 


* NEALE BRASSELL [28-JUN-78] 


2900 








J% ^% 

0003 


ft 






2900 








M 

0004 


lOLOC 


EQU 


2900H 


2900 








0005 


MZOS 


EQU 


2028H 


2900 








^ 

0006 








2900 








0007 








2900 








— 

0008 


* THIS 


IS JUST A JUMP TO MZO 


2900 








0009 








2900 








0010 




ORG 


lOLOC 


2900 








0011 








2900 


C3 


28 


20 


0012 


REENT 


JMP 


MZOS 


2903 








0013 


sic 






2903 








0014 








2903 








0015 


* THIS 


IS THE TINIT (TERMINA 


2903 








0016 


* 






2903 








0017 




ORG 


IOLOC+16 


2910 








0018 


4r 






2910 


AF 






0019 


INI8 


XRA 


A 


2911 


D3 


03 




0020 




OUT 


3 


2913 


D3 


03 




0021 




OUT 


3 


2915 


D3 


03 




0022 




OUT 


3 


2917 


3E 


40 




0023 




MVI 


A,40H 


2919 


D3 


03 




0024 




OUT 


3 


291B 


3E 


CE 




0025 




MVI 


A,OCEH 


29 ID 


D3 


03 




0026 




OUT 


3 


291F 


3E 


27 




0027 




MVI 


A,27H 


2921 


D3 


03 




0028 




OUT 


3 


2923 


C9 






0029 




RET 




2924 








0030 








2924 








.^k ^ 

0031 








2924 








0032 


* THIS 


CHECKS FOR <"C>, AND 


2924 








0033 


X 






2924 








^k. m 

0034 




ORG 


IOLOC+64 


2940 








0035 


■ 

* 






2940 


CD 


DC 


CO 


0036 


CHK8 


CALL 


OCODCH 


2943 


FE 


03 




0037 




CP I 


3 


2945 


C8 






.^m- .^^h 

0038 




RZ 




2946 


FE 


20 




0039 




CPI 


32 


2948 


CO 






0040 




RNZ 




2949 


CD 


60 


29 


0041 




CALL 


INS 


294C 


FE 


03 




0042 




CPI 


3 


294E 


C9 






0043 




RET 




294F 








0044 


4c 






294F 








0045 


4c 






294F 








0046 


* THIS 


IS THE CONSOLE INPUT 


294F 








0047 


4c 






294F 








0048 




ORG 


IOLOC+96 


2960 








0049 


4c 






2960 


CD 


DC 


CO 


0050 


INS 


CALL 


OCODCH 


2963 


CA 


60 


29 


0051 




JZ 


INS 


2966 


E6 


7F 




0052 




ANI 


127 


2968 


09 






0053 




RET 




2969 








0054 


4c 







2969 0055 * 

2969 0056 * CONSOLE OUTPUT - IF A-1 THEN THE PRINTER IS USED 

2969 0057 * 

2969 0058 ORG IOLOC+128 

2980 0059 * 

2980 FE 01 0060 0UT8 CPI 1 

2982 CA CO 29 0061 JZ OUTPR 

2985 78 0062 MOV A,B 

2986 C3 98 CO 0063 JMP 0C098H 
2989 0064 * 

2989 0065 * 

2989 0066 * PRINTER OUTPUT - JUST USES CONSOLE 

2989 0067 * 

2989 0068 ORG I0L0C+I92 

29C0 0069 * 

29C0 78 0070 OUTPR MOV A,B 

29C1 C3 98 CO 0071 JMP 0C098H 

29C4 0072 * 



SYMBOL TABLE 



CHK8 2940 IN8 2960 INI8 2910 
OUTS 2980 OUTPR 29C0 REENT 2900 



lOLOC 2900 MZOS 2028 
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APPENDIX C: SANPI£ DIRECTORY LISTING 

Here is a sample listing, as produced by the LI comnand. 



MZOS 


4 


10 


P 


00 


BASIC 


14 


45 


01 2A00 


DEX 


59 


23 


P 


01 2A00 


TESTFL 


82 


4 


02 


lOSYS 


86 


90 




08 


DATAFILE 


176 


250 


03 


INXFILE 


426 


50 




03 











Here is an analysis of the above listing. 

MZOS is a file, starting at address (sector) 4 and taking 10 sectors. It is 
protected, so it cannot be deleted. 

BASIC is a 45-sector machine code file, starting at address 14. It's ram 

starting address is 2A00. It could be executed by typing *G0 BASIC', or just 
■BASIC. 

DEX is a machine code file, similar to BASIC. It is protected, though. Its 
starting ram address is also 2A00. 

TESTFL is a BASIC program (type 2) , which can be loaded and executed with 

BASIC. 

lOSYS is a DEX source file (type 08) . 

DATAFILE is a rather large BASIC data file (type 3). It is accessed with RBJVD 
and VZEULTE statements in BASIC. 

INXFII£ is a BASIC data file, like DATAFILE. 



MZ06 Utilities 
by Vector Graphic Inc. 



There are three utility programs provided on your system disk as received from 
Vector GrajAiic. They are DIAB^ CENT, and NS2MZ. Here we will provide you with 
source listings and instructions for their use. 

The first r DIAB, is a driver routine for a Diablo printer. It assumes that you 
are using ports 2 and 3 for the printer, and that the printer is the version 
that runs at 1200 baud, with handshaking logic. 

The second, CENT, is for a Centronics printer, such as 781, 702, etc. with 
parallel handshaking logic. Port 1 is used for this printer. 

For both routines, they m^ be invoked ty simply typing the name of the one you 
want, either DIAB or CENT. If you want to save MZOS with caie of these routines 
incorporated into it, you would just type SF MZOS 2000 after loading the driver. 
Exanple: 



The system on the diskette now has the driver incorporated in it. 

Notice (in the source listings) that the various routines are spaced over the 
entire 2900-29FF block allocated to them. Itxis is so that you can change the 
drivers without changing the junp table in MZOS. Ttie current assignments are as 
follows: 



The reentry spot is so that this can be executed as a program, allowing you to 
type 'DIAB' instead of 'LF DIAB 2900'. 

There are a couple of features included in the input and output routines to 
complement the printer. First, when you type a control-P, the input routines 
toggles the printer flag, th^ discards the character. This way, even if your 

program doesn't allow control characters, typing control-P will still work. 
What toggling the printer flag actually does is to allow output to go to both 
the console and the printer. Typing control-P a second time will turn the 
printer off, etc. Second, typing control-L will send a formfeed to the printer, 

and discard the character. This should be done before you print something the 
first time, as it also sets the line counter. The output is paged; every 56 

lines, it skips to the top of the next page. Checking the listings provided 
should help you understand how the system works. 



#DIAB 

#SF mOS 2000 




jump back to MZOS 

initialize 

control-C check 

input character 
output character 

output character to printer 



The last utility provided is the NS2MZ program, which, as its name iirplies, 

transfers files from North Star disk to MZOS. It is a simple program, as you 
can see from the listing. To use it, first initialize a disk with MZOS. Then 
load the NS2MZ program into memory, anywhere EXCEPT from 2000 to 3400. The 
program is relocatable, so it doesn't matter; we recommend that you load it at 
4000. Next, boot your North Star DOS. Insert the disk you want to copy into 
drive 1 (North Star), and the disk you just initialized into drive 1 
(Micropolis) . Now JP to whatever address you loaded the program at. It will 
copy the entire disk, exactly as it is, onto the Micropolis disk. Now insert a 
system disk into the Miropolis drive and boot MZOS. Type LF MZOS 3000 (load 
MZOS into memory) , then insert the new diskette; type SF DOS 3000 (which saves 
it onto the disk) followed by EN DOS MZOS (vrtiich renames the DOS to MZOS) . You 
now have your North Star diskette on Micropolis disk. This procedure may be 
repeated for each disk you wish to copy. Note, though, that the disk is copied 
onto another disk exactly, so you may only copy disks one-to-one. Since the 
Micropolis disks hold more, you may want to merge several disks together 
manually after you've copied them. 



2900 




F 


0001 


* MZOS DIABLO I/O SYSTEM 


2900 




r 


0002 


* NEALE BRASSELL [28-JUN-78] 


2900 






0003 


* 




2900 






0004 


lOLOC EQU 


2900H 


2900 






0005 


MZOS EQU 


2028H 


2900 






0006 


* 




2900 






0007 


* 




2900 






0008 


* THIS IS JUST A JUMP TO MZOS, AS A REENTRY POINT 


2900 






0009 


* 




2900 






0010 


ORG 


lOLOC 


2900 






0011 


* 




2900 


C3 28 


20 


0012 


REENT JMP 


MZOS 


2903 






0013 


* 




2903 






0014 


* 




2903 






0015 


* THIS IS THE TINIT (TERMINAL INITIALIZATION) ROUTINE 


2903 






0016 


* 




2903 




■ 


0017 


ORG 


IOLOC+1 6 


2910 






0018 


* 




2910 


AF 




0019 


INI8 XRA 


A 


2911 


D3 03 


■ 


0020 


OUT 


3 


2913 


D3 03 




0021 


OUT 


3 


2915 


D3 03 


r 


0022 


OUT 


3 


2917 


3E 40 




0023 


MVI 


A,40H 


2919 


D3 03 




0024 


OUT 


3 


291B 


3E CE 




0025 


MVI 


A,OCEH 


291D 


D3 03 




0026 


OUT 


3 


291F 


3E 27 




0027 


MVI 


A,27H 


2921 


D3 03 




0028 


OUT 


3 


2923 


C9 




0029 


RET 




2924 






0030 


* 




2924 






0031 


* 




2924 






0032 


* THIS CHECKS FOR <''C>, AND SUSPENDS OUTPUT ON <SPACE> 


2924 






0033 


* 




2924 






0034 


ORG 


IOLO&f64 


2940 






0035 


* 




2940 


CD DC 


CO 


0036 


CHK8 CALL 


OCODCH 


2943 


FE 03 




0037 


CP I 


3 


2945 


C8 




0038 


RZ 




2946 


FE 20 




0039 


CPI 


32 


2948 


CO 




0040 


RNZ 




2949 


CD 60 


29 


0041 


CALL 


INS 


294C 


FE 03 




0042 


CPI 


3 


294E 


C9 


L 


0043 


RET 




294F 






0044 


* 




294F 






0045 


* 




294F 






0046 


* CONSOLE INPUT - <^P> & <"L> ARE HANDLED SPECIALLY 


294F 






0047 


* 




294F 






0048 


ORG 


IOLOC+96 


2960 






0049 


* 




2960 


CD DC 


CO 


0050 


INS CALL 


OCODCH ;GET CHARACTER 


2963 


Ck 60 


29 


0051 


JZ 


INS 


2966 


FE 10 




0052 


CPI 


16 ;SEE IF "P 


2968 


CA 75 


29 


0053 


JZ 


CTLP 


296B 


FE OC 




0054 


CPI 


12 :SEE IF "L 



4 





CO 






0055 




RNZ 




; RETURN IF NOT 


O /\ £ T< 

29dE 


47 






0056 




MOV 


B,A 




296F 


CD 


CO 


29 


0057 




CALL 


OUTPR 


;SEND FORMFEED 


^ T o 

2972 


C3 


60 


29 


0058 




JMP 


INS 


;DISCARD CHARACTER 


r\ r\ ^ ^ 

2975 


3A 


FB 


29 


0059 


CTLP 


LDA 


OUTFL 




^ n 

2978 


2F 






0060 




CMA 






A ^ *^ ^ 

2979 


32 


FB 


29 


0061 




STA 


OUTFL 


;"P COMPLIMENTS PRINTER FLAG 


297C 


C3 


60 


29 


0062 




JMP 


IN8 


;AND DISCARD CHARACTER 


297F 








0063 


* 








297F 








0064 


* 








A A ^ V4 

297F 








0065 


* OUTPUT CHARACTER - IF 


A-l» THEN USE DIABLO 


297F 








0066 


* 








297F 








0067 




ORG 


lOLOOl 28 




A ^ A ^\ 

2980 








0068 


* 








A A A A 

2980 


FE 


01 




0069 


OUTS 


CP I 


1 




A A A 

2982 


CA 


CO 


29 


A A ^ A 

0070 




JZ 


OUTPR 


;IF A-1 THEN USE PRINTER 


A ^ ^ 

2985 


78 






^\ ^ 4 

0071 




MOV 


A,B 




A ^ 

2986 


CD 


98 


CO 


A A ^ /\ 

0072 




CALL 


0C098H 


;SEND CHARACTER TO CONSOLE 


j% o 

2989 


3A 


FB 


29 


A A ^ ^ 

0073 




LDA 


OUTFL 




.^4 

298C 


B7 






A A ^ 

0074 




ORA 


A 


; CHECK PRINTER FLAG 


298D 


78 






*V ^ 

0075 




MOV 


A,B 




0S ^ ^ VI 

298E 


C8 






A A ^ ^ 

0076 




RZ 




; RETURN IF NOT SET 


A A A MB 

298F 


C3 


CO 


29 


^ ^ ^ 

0077 




JMP 


OUTPR 


;SEND TO PRINTER IF SET 


A A A 

2992 








0078 


* 








2992 








0079 


* 








A ^ A 

2992 








0080 


* DIABLO PRINTER OUTPUT 


ROUTINE 


^ ^ A A 

2992 








A A A t 

0081 


* 








M A A A 

2992 








A A A A 

0082 




ORQ 


IOLOC+X92 




^ tfV #v 

29C0 








A A A ^ 

0083 


* 








A ^ M A 

29C0 


DB 


03 




AAA/ 

0084 


OUTPR 


IN 


3 




n 

29C2 


E6 


01 




A A A P 

0085 




ANI 


1 




# 

29C4 


CA 


CO 


29 


A A A 

0086 




JZ 


OUTPR 


;WAIT FOR READY FROM USART 


^4 ^9 

29C7 


78 






A ^ 

0087 




MOV 


A,B 




29C8 


D3 


02 




A A 

0088 




OUT 


2 


;SEND CHARACTER 


A 

29CA 


FE 


OA 




jfc ^% 

0089 




CP I 


10 


;SEE IF LINEF£;ED 


MA 

29CC 


CA 


D9 


29 


0090 




JZ 


ITALF 




29CF 


FE 


OC 




4 

0091 




CPI 


12 


;SEE IF FORMFEED 


« 

29D1 


CO 






A A A 

0092 




RNZ 




; RETURN IF NOT 


29D2 


3E 


38 




A A A A 

0093 




MVI 


A, 56 




# 

29D4 


32 


FC 


29 


^% M 

0094 




STA 


LNCNT 


;RESET PAGE COUNTER ON FORMFEED 


A «fc 

29D7 


78 






P 

0095 




MOV 


A,B 




29D8 


C9 






A A A ^ 

0096 




RET 






^% 

29D9 


C5 






f% A A ^ 

0097 


ITALF 


PUSH 


B 




29DA 


06 


03 




A A A A 

0098 




MVI 


B,3 


;SEND ETX CHARACTER AFTER LINEFEED 


29DC 


CD 


CO 


29 


A A A A 

0099 




CALL 


OUTPR 




29DF 


DB 


03 




0100 


WTACK 


IN 


3 




29E1 


E6 


02 




A t A 1 

0101 




ANI 


2 




29E3 


CA 


DF 


29 


A 1 A A 

0102 




JZ 


UTACR 


;WAIT FOR ACKNOWLEDGE 


A ^ ^ 

29E6 


DB 


02 




A 1 A^ 

0103 




IN 


2 


; GOBBLE CHARACTER 


29E8 


CI 






0104 




POP 


B 




29E9 


3A 


FC 


29 


0105 




LDA 


LNCNT 




29EC 


3D 






0106 




DCR 


A 


;ADJUST LINE COUNTER 


29ED 


32 


FC 


29 


0107 




STA 


LNCNT 




29F0 


78 






0108 




MOV 


A,B 




29F1 


CO 






0109 




RNZ 




; RETURN IF NOT FULL PAGE 


29F2 


C5 






0110 




PUSH 


B 





29F3 06 OC 






0111 


MVI 


B,12 


;WHEN FULL PAGE, 


29F5 CD CO 29 






0112 


CALL 


OUTPR 




29F8 CI 






0113 


POP 


B 




29F9 78 






0114 


MOV 


A»B 




29FA C9 






0115 


RET 




;AND RETURN 


29FB 






0116 * 














Oil/ OUTFL 


Do 


u 


;rRXNirjK rLAb 


29FC 38 






0118 LNCNT 


DB 


56 


;LINE COUNTER 


29FD 






0119 * 








SYMBOL TABLE 










■ 




CHK8 2940 


CTLP 


2975 


IN8 2960 


INI8 2910 


lOLOC 2900 


ITALF 29D9 


LNCNT 


29FC 


HZOS 2028 


GUTS 2980 


OUTFL 29 FB 


OUTPR 29C0 


REENT 


2900 


WTACK 29DF 







SEND FORMFEED 



I 



2900 








0001 

www X 


* MZOS 


CENTRONICS l/O SYSTEM 


2Q00 






r 


0009 

\J\J\J4L 


* NEALE BRASSELL [28-JUN-78] 


2Q00 








ono^ 

vwU J 


* 






2Q00 

4m 7 WW 








OOOA 

WwH 


TOT OC. 


EQU 


2900H 


2Q00 

4U 7 WW 








ooos 

wwU J 


MZOS 


EQU 


2028H 


2Q00 

^ 7 WW 








OOOfi 

wwUQ 


* 






2Q00 

^ 7 W W 








0007 


* 






2900 

^ WW 








0008 

WW WW 


* THIS 

xux o 


IS JUST A JUMP TO MZOS, AS A REENTRY POINT 


2Q00 

^ 7 WW 








OOOQ 


* 






2Q00 

^ 7 WW 








001 n 




ORG 


lOLOC 


2900 

^ 7 W W 
















2Q00 

^ 7 WW 




28 


20 


001 9 


REENT 


JMP 


MZOS 


2901 

^ 7 W^ 








001 3 


* 






2903 

^ 7 W*,# 








0014 

W W X H 


* 






2903 

^ ^ \J 'mJ 








0015 

WW X ^ 


* THIS 


IS THE TINIT (TERMINAL INITIALIZATION) ROUTINE 


2903 

^ 7 W *^ 








0016 

WW X w 


•k 






2903 

A* ^ V ^ 








0017 

WW X 9 




ORG 


lOLOOf 1 6 


2910 

A* ^ W 








0018 

W W X IJ 


it 






2910 

At 7 X W 


AF 






0019 

WW X 7 


IN 18 


XRA 


A 


2911 

At 7 J» 4» 


D3 


03 

w ^ 




0020 




OUT 


3 


2913 

^ 7 ^ J 


D3 


03 




0021 

WW^ X 




OUT 


3 


2915 

^ 7 X «/ 


D3 


03 




0022 




OUT 


3 


2917 

^ 7 X f 


3E 


40 

*T W 




0023 

WW X. ^ 




MVI 


A,40H 


2919 


D3 


03 




0024 

WW 




OUT 


3 


291B 


3E 


CE 




0025 




MVI 


A^OCEH 


2Q1D 


T)3 

X/^ 


03 

W J 




0026 




OUT 


3 


4U 7 X x 


3F 


27 




0027 

\j\J £. 1 




MVI 


A,27H 


^ 7 ^ X 


n3 


03 




0028 




OUT 


3 


2923 

«> 7 ^ J 


n9 

W 7 






002Q 




RET 




202A 










* 






2Q2A 








0031 

\J\J 3 X 








2Q2A 








0032 


* THIS 

X AX 4* W 


CHECKS FOR <'"C>, AND SUSPENDS OUTPUT ON <SPACE> 


292^ 

^ 7 








0033 


* 






292^ 

^ 7 








0034 




ORG 


I0L0Cf64 


7 H V 








003S 

\J\J 


* 






29^0 

^ 7 t W 


CD 

v>x/ 


DC 


CO 

WW 


0036 

WW J w 


CHK8 


CALL 


OCODCH 


29^3 

^ 7 H ^ 


X u 


w<? 








CP I 


3 


2945 


C8 






0038 

WW^W 




RZ 




2946 

*■ 7 ^ w 


FE 

X 1-J 


20 

x» w 




0039 

WW J 7 




CPI 


32 


2948 

^ 7 *T W 


CO 

WW 






0040 

W W*T w 




RNZ 




2949 

^ 7 *T 7 


CD 

wx/ 


60 

WW 


29 


0041 

W W"T X 




CALL 


INS 


294C 

^ 7 ^ W 


FE 

X XJ 


03 

w 




0042 

WW"T Xt 




CPI 


3 


294E 


09 






0043 




RET 




294F 

X* 7 ^X 








0044 

W W*T*T 


* 






294F 

Xr 7 "TX 








0045 

W W 


* 






294F 

X> 7 "TX 








0046 

WW"T W 


* CONSOLE INPUT - <"P> & <'^L> ARE HANDLED SPECIALLY 


294F 








0047 

^/ W r 


* 






294F 








0048 




ORG 


IOLOC+96 


2960 








0049 


•k 






2960 


CD 


DC 


CO 


0050 


INS 


CALL 


OCODCH ;GET CHARACTER 


2963 


OA 60 


29 


0051 




JZ 


INS 


2966 


FE 


10 




0052 




CPI 


16 ;SEE IF "P 


2968 


CA 


75 


29 


0053 




JZ 


CTLP 


296B 


FE 


DC 




0054 




CPI 


12 jSEE IF "L 



29F3 CI 
29F4 78 
29F5 C9 
29F6 

29F6 00 
29F7 38 
29F8 



0111 
0112 

0113 
0114 * 

0115 
0116 
0117 



POP 
MOV 
RET 



OUTFL 
LNCNT 



DB 
DB 



B 

A,B 



0 

56 



;AND RETURN 



; PRINTER FLAG 
;LINE COUNTER 



SYMBOL TABLE 



CHK8 2940 
ITALF 29E4 
OUTPR 29 CO 



CTLP 2975 

LNCNT 29F7 
REENT 2900 



IN8 



2960 



MZOS 2028 



INI8 2910 
OUTS 29 80 



lOLOC 2900 
OUTFL 29 F6 



0000 






0001 * 








0000 






0002 * NORTH STAR TO MZOS DISK 


COPY PROGRAM 


0000 






0003 * NEALE BRASSELL [26-JUN- 


78] 


0000 


r 


r 


0004 * 








0000 






0005 * THIS PROGRAM IS 100% RELOCATABLE. 


0000 




w 


0006 * 








0000 






0007 MZ 


EQU 


0C402H 


;MZ0S DCOM ROUTINE 


0000 






0008 NS 


EQU 


02022H 


;N0RTH STAR DCOM ROUTINE 


0000 




r 

r 


0009 * 








0000 


r 


■ 


0010 DJNZ 


EQU 


lOH 




0000 






0011 * 








0000 


3E OA 




0012 NS2MZ 


MVI 


A, 10 


;10 SECTORS AT A TIME 


0002 


06 23 




0013 


MVI 


B,35 


;35 SUCH TRANSFERS 


0004 


OE 01 




0014 


MVI 


c.i 


;WE'LL USE DISK 1 


0006 


11 00 


2A 


0015 


LXI 


D , 2 AO OH 


•.TYPICAL BUFFER SPOT 


0009 


21 00 


00 


0016 


LXI 


H,0 


; START FROM THE BEGINNING 


oooc 


C5 




0017 N2M 


PUSH 


B 


;SAVE COUNTER 


OOOD 


06 01 




0018 


MVI 


B.l 


;READ FROM NS 


OOOF 


F5 




0019 


PUSH 


PSW 




0010 


D5 




0020 


PUSH 


D 




0011 


E5 




0021 


PUSH 


H 


■ 


0012 


CD 22 


20 


0022 


CALL 


NS 


;« DO IT » 


0015 


El 




0023 


POP 


H 




0016 


Dl 




0024 


POP 


D 




0017 


Fl 


■ 


0025 

\J \J 4m ^ 


POP 


PSW 




0018 


06 00 


■ 


0026 


KVI 


B»0 


;WRIXE TO MZ 


OOIA 


CD 02 


C4 

r 


0027 


CALL 


MZ 


•<< no IT >> 


OOID 


D5 




0028 


PUSH 


D 


;SA7E DE 


OOIE 


11 OA 


00 


0029 


LXI 


D.IO 


;TEN SECTORS DONE 




1 Q 




0030 


DAD 


D 


; REFLECT THIS 


0022 


Dl 




0031 


POP 


D 


; RESTORE DE 


0023 


CI 




0032 


POP 


B 


;6ET COUNTER 


0024 


10 




0033 


DB 


DJNZ 


;USE NEAT Z-80 CODE 


0025 


E6 




0034 


DB 


N2M-$-l 


;T0 EFFECT A LOOP 


0026 


C9 




0035 


RET 


w 


;HOPEF[JLLT RETURN TO WHOEVER 


0027 






0036 * 






* 


SYMBOL TABLE 








1 


DJNZ 


0010 


MZ 


C402 N2M OOOC 


NS 2022 


NS2MZ 0000 



2A0U 
2AU0 
2AUU 
2A00 AF 

2AU1 06 3E 

2A03 CD OD 20 

2A06 3E 01 

2A0a 01 01 01 

2A0B 11 00 2B 

2A0E 21 04 00 

2A11 CD 22 20 
2A14 AF 

2A15 06 3A 

2A17 CD OD 20 
2A1A 21 00 2B 

2A1D 06 09 
2A1F CD 10 20 
2A22 FE OD 
2A24 26 
2A25 09 
2A26 47 
2A27 AF 
2A28 CD 
2A2B 70 
2A2C 23 
2A2D 10 
2A2E FO 
2A2F 2B 
2A30 3E oO 
2A32 86 
2A33 77 
2A34 06 3C 
2A36 AF 
2A37 CD OD 20 
2A3A 3E 01 
2A3C 01 01 00 
2A3F 11 00 28 

2A42 21 04 00 
2A45 CD 22 20 
2A4b C3 2b 20 



OD 20 



LOOP 



0001 
0002 
0003 
0004 TITLE 
0005 
0006 
0007 

0008 
0009 
0010 
0011 
0012 
0013 
0014 
0015 
0016 
0017 
0018 
0019 
0020 
0021 
0022 
0023 
0024 
0025 

0026 
0027 
0028 

0029 
0030 
0031 
0032 
0033 
0034 

0035 
0036 
0037 

0038 

0039 
0040 



* Lime raOGRAM TO TITLE A DISK 

* NEAI£ BRASSELL [12-JUL-78] 



CR 



XRA 

MVI 

CALL 

MVI 

LXI 

LXI 

LXI 

CALL 

XRA 

MVI 

CALL 

LXI 

MVI 

CALL 

CPI 

DB 

DB 

MOV 

XRA 

CALL 

MOV 

INX 

DB 

DB 

DCX 

MVI 

ORA 

MOV 

MVI 

XRA 

CALL 

MVI 

LXI 

LXI 

LXI 

CALL 
JMP 



A 

B,'>' 
020 ODH 

A, l 

B, 101H 

D,2B00H 
H,4 

02022H 

A 

B, ' : ' 

0200DH 

H,2B00H 

B,9 

2010H 

13 

28H 

CR-$-l 

B,A 

A 

200DH 
M,B 

H 

16 

LOOP-$-l 
H 

A, 128 
M 

M,A 

B, '<' 
A 

0200DH 

A, l 

B, l 

D,2B00H 

H,4 

2022H 
2028H 



;OOTPUT NOTE 



•READ IN MZ06 



;FROMPT 



;GET CHARACTER 
;IF <CR>, END 



;CGNTINUE 



;WRITE MZOS BACK 



SYMBOL TABLE 



CR 



2A2F 



LOOP 2A1F 



TITLE 2A00 



This is a program which will title a disk for you. The title will be printed whenever you 
boot the disk. To run, put a system disk into drive 1, copy this program onto it, then 
type TITLE- The program will print >, indicating that it is reading in MZOS. It will then 
print : and wait for you to type the title. Maximum is 9 characters, and terminate with 
CR. Make no errors - no provision is made for backspacing. After CR or nine characters, 
it will print <, then write MZOS back onto disk. Reboot and observe the result. This 
program is set up to run at 2A00, and use a buffer from 2B00-2C00. The program itself is 
relocatable, so you can put it elsewhere by changing the starting address (for example, 
TY TITLE 1 0 to run at 0000). You can change the program (lines 9 and 15) to use a different 
buffer area, also. Note that in order to title a disk, it MUST have MZOS as the first file. 



